home *** CD-ROM | disk | FTP | other *** search
/ CD Ware Multimedia 1994 November / Cd Ware (Nro. 2) - Epimundo.iso / OS2 / GMSG2104.ZIP / GENMSG.DOC < prev    next >
Encoding:
Text File  |  1994-04-22  |  12.7 KB  |  256 lines
  1.                     GenMsg Copyright (c) 1992, 1993, 1994
  2.                                  G. K. Pace
  3.                               OS2 Version 1.04
  4.                                April 22, 1994
  5.  
  6.  DESCRIPTION:
  7.      GenMsg is a FidoNet compatable message  viewer/editing system  designed 
  8.  for systems using the *.msg format  of message  storage.  It  is a  "shell" 
  9.  type system. There isn't a text-editor  built in,  you use  GenMsg to  call 
  10.  your favorite Ascii Text editor (I use TE a very good editor) to edit  the 
  11.  text - GenMsg then formats it  to FidoNet  specifications for  the type  of 
  12.  message it is.  GenMsg can also shell to other utilities...  Such as Pretty 
  13.  Good Privacy (PGP) a "free-ware" Public Key encryption system.  PGP can  be 
  14.  called  by  GenMsg  for  decoding encrypted  messages, and  for encrypting, 
  15.  signing, or clear-text signing of messages.
  16.  
  17.      GenMsg  was  the  first  FidoNet message  editor available  which would 
  18.  interface PGP  to Fidonet  messages.  Today  it is  the most  up-to-date of 
  19.  those which have come since... <grin>
  20.  
  21.  FEATURES:
  22.      GenMsg supports the D'Bridge mailer, and  can be  setup to  replace the 
  23.  Internal Editor, or as an alternate Editor to be used as needed.  Refer to 
  24.  the enclosed DBRIDGE.TXT file for information on configuring for use with 
  25.  D'Bridge.
  26.  
  27.      GenMsg  supports  the SecureMail  principal, and  can be  configured to 
  28.  refuse to show the  contents of  in-transit messages...   for you  "snoopy" 
  29.  types, you can disable this and view anything on your system... <grin>  
  30.  Registered versions also include the function for returning E-Mail which 
  31.  cannot be delivered (for those who Route Mail for others) in a secure 
  32.  fashion... the text of message is not viewed when using this function.
  33.  
  34.      GenMsg  supports  the  use  of  Pretty  Good Privacy  (PGP) for  use in 
  35.  handling  encrypted,  ascii-armor,  and  clear-text  signatures  in FidoNet 
  36.  messages.
  37.  
  38.      GenMsg is designed to utilize the Ascii-text editor of your  choice, so 
  39.  that the editing commands can be as you prefer.
  40.  
  41.      GenMsg can handle messages of upto 64K in length.
  42.  
  43.      GenMsg provides  full INTL  and POINT  addressing.  Default  addressing 
  44.  style allows shortcuts in address entry.  For example, to address to node 
  45.  12 in your net, just enter 12 when prompted for the INTL address.  To 
  46.  address it to point 3 of node 12 in your Net, enter 12.3...
  47.  
  48.      GenMsg  provides  for  a  Configurable "default"  ORIGIN line,  and the 
  49.  ability to  configure each area differently thru use of a file named ORIGIN 
  50.  in each directory.
  51.  
  52.      GenMsg supports the use of UTC message dating.  Since this is not a 
  53.  FidoNet standard, the Date is "hidden" behind a CTRL-A in the typical 
  54.  FidoNet Kludge fashion...
  55.  
  56.      GenMsg provides "Auto Formatting" of messages destined to  the Internet 
  57.  via a gate-way.  If you set up GenMsg for using a uucp-gate, it will 
  58.  automatically format such messages for you.
  59.  
  60.  SETUP:
  61.      GenMsg requires that you  have a  configuration file  named GenMsg.ini.  
  62.  If you will be accessing EchoMail and/or LocalMail message areas,  you will 
  63.  need an "areas.bbs" type list of those areas.  You will also have to have a 
  64.  Text  Editor  which  can  be  called  from GenMsg,  and for  the encryption 
  65.  features you will need Pretty Good Privacy (PGP).
  66.  
  67.      GenMsg.ini:
  68.      The  configuration  file  GENMSG.INI  must  be  in  the  same directory 
  69.  GENMSG.EXE  is  in.   If  you rename  GENMSG.EXE, you  will have  to rename 
  70.  GENMSG.INI  to  match.   (example:  if GENMSG.EXE  is renamed  to GMSG.EXE, 
  71.  GENMSG.INI must be renamed GMSG.INI)
  72.  
  73.      GENMSG.INI must contain setup  information specifying  your name,  INTL 
  74.  address, the  Ascii-text Editor  to call,  and the  directory path  to your 
  75.  NetMail.  There are many other optional  parameters that  can or  should be 
  76.  set  for  your  apprication.   Refer  to  the  accompanying  GENMSG.INI for 
  77.  information on how to configure GenMsg.
  78.  
  79.  
  80.      Message Areas List:
  81.      Unless you are going to use GenMsg for your NETMAIL area only, you will 
  82.  need to have a list of other message areas GenMsg  can access.   GenMsg can 
  83.  use the "standard" AREAS.BBS, or can be configured to use another list that 
  84.  you've created.   Since the  standard AREAS.BBS  does not  normally include 
  85.  LOCAL message areas, the method of having a separate list for GenMsg to use 
  86.  is generally prefered.  The name of such file can be any legal DOS name and 
  87.  must be specified in GENMSG.INI.
  88.  
  89.      The  format  of  this  list  is  explained  more  fully  in   the  file 
  90.  MSGAREAS.BBS which has been included as an example  of how  to create  this 
  91.  list.
  92.  
  93.  
  94.      ENVIRONMENT:
  95.      GenMsg calculates the UTC date and time based  upon your  system clock, 
  96.  and expects to find the environment variable TZ  to be  set indicating  the 
  97.  time shift between your local time, and Greenwich  Mean time.   To set  the 
  98.  variable use the DOS command Set in your Autoexec.bat file as:
  99.  
  100.  SET TZ=EST5      (Eastern Standard time)
  101.  SET TZ=EST5EDT   (Eastern Daylight savings time)
  102.  
  103.      The first three alpha characters should  be the  abbreviation for  your 
  104.  standard time zone. the (next) single digit should be the  offset in  hours 
  105.  from Greenwich Mean time for your standard time zone.
  106.      If your locality uses  Daylight Saving  time, you  should add  the last 
  107.  three alpha characters, which automatically compensate for daylight savings 
  108.  when it should be active, for calculating UTC...
  109.  
  110.  
  111.      You SHOULD also have the PGP environment variable  PGPPATH=pgpstuff set 
  112.  for PGP to act properly.  Refer to the PGP Docs for this information!
  113.  
  114.  
  115.      SETUP of PGP PASS-PHRASE:
  116.      GenMsg provides for the installation of your pass-phrase to enhance the 
  117.  ease of use of PGP.  When installed, GenMsg secures the  pass-phrase in  an 
  118.  encrypted form inside of the GenMsg.EXE file.  It will then decrypt it, and 
  119.  pass it to PGP when it calls PGP, upon return from PGP the  decrypted pass- 
  120.  phrase is distroyed.  GenMsg will only accept your pass-phrase  for storage 
  121.  if it can obtain the required information from your system that it needs to 
  122.  store  it  in  a  secure manner.  Not all  systems will  have the  required 
  123.  information available -  thus this option may not be available to all Users 
  124.  of GenMsg.
  125.  
  126.      GenMsg provides yet another degree of security for the USE of the pass- 
  127.  phrase.  When installing the pass-phrase you will be asked for a GenMsg 
  128.  password.  This password should not be the same as your PGP pass-phrase.  
  129.  The GenMsg password can be a phrase (include spaces, etc.) and it must be 
  130.  at least six but not exceeding 79 characters in length.
  131.  
  132.      Once  the  pass-phrase  is  installed  GenMsg  will  check  the  system 
  133.  information each time it is envoked, if it doesn't match the information it 
  134.  has stored,  it will  refuse to  use the  copy of  the pass-phrase  and the 
  135.  GenMsg password it contains to keep it secure.  GenMsg will also refuse  to 
  136.  use it  if the  GenMsg.EXE is  copied to  another Disk  and envoked,  or if 
  137.  envoked on another system.
  138.  
  139.      To  install  your  pass-phrase  envoke  GenSet  with  the  command-line 
  140.  argument indicating the pathfilename  of the  copy of  GenMsg.exe it  is to 
  141.  modify (i/e GenSet GenMsg.exe). GenSet will  ask you  for your  pass-phrase 
  142.  and if it can obtain all  of the  system information  it requires,  it will 
  143.  store the pass-phrase.  If you do not enter anything when prompted to enter 
  144.  your  pass-phrase,  GenSet  will  delete  any  pass-phrase  it  might  have 
  145.  previously contained.  (a useful  way to  insure that  your pass-phrase  is 
  146.  erased from any copies of GenMsg  you may  copy for  a friend)  Once setup, 
  147.  GenMsg will keep the pass-phrase for use until you change  it, or  any part 
  148.  of the system information it monitors changes causing  GenMsg to  refuse to 
  149.  use the pass-phrase.
  150.  
  151.      When envoking GenMsg, the use of the stored pass-phrase is DISABLED for 
  152.  security reasons.  To ENABLE it you  must use  the command  ALT-E from  the 
  153.  main  (message  view)  menu.   When enabling  the pass-phrase  you will  be 
  154.  required to enter the GenMsg password.  The ALT-E command is  a toggle,  so 
  155.  subsequent use  of it  will disable  the use  of the  pass-phrase for  that 
  156.  session, and is a useful way of securing your system for brief trips to get 
  157.  coffee.
  158.  
  159.      ORIGIN:
  160.      GenMsg will use the string you setup in  GENMSG.INI as  the ORIGIN  for 
  161.  messages you create (NOT NetMail messages) unless it finds a file named 
  162.  ORIGIN in the message directory.  This feature provides the ability for you 
  163.  to customize the origin line you use for each Echo message area.   The file 
  164.  ORIGIN is an Ascii-Text file with  one string  in it.   The string  will be 
  165.  trunicated if it is too long... Origin lines must not exceed 79 characters, 
  166.  including your INTL address.
  167.  
  168.      D'Bridge:
  169.      GenMsg can fit in with D'Bridge nicely.  To  use it  with D'Bridge  you 
  170.  must enable  D'Bridge mode  in your  GENMSG.INI, and  have the  ENVIRONMENT 
  171.  variable of DB=path_to_DBridge or DBRIDGE=path_to_DBridge set.
  172.  
  173.      GenMsg can function as a replacement for the D'Bridge Internal  Editor.  
  174.  Refer  to  the  accompanying  DBRIDGE.TXT  file  for  further   information 
  175.  concerning setup.
  176.  
  177.  
  178.  
  179.      PGP USE:
  180.       GenMsg (if setup to emplement this feature) will call PGP  to Encrypt, 
  181.  Ascii-Armor Sign, Clear-Text Sign, or Decrypt a message.  Assuming you Have 
  182.  PGP setup properly, and enabled in GenMsg...
  183.  
  184.      Decode Function:
  185.       This function will call PGP to decode the message-text of  the message 
  186.  you are viewing.  If the text contains a Public Key,  PGP will  process it, 
  187.  and allow you to add it to your Key-Ring.  If  the text  contains a  Signed 
  188.  Public Key  (some people  do this???  !!!) The  first Decode  Function will 
  189.  remove the Clear-Text Signature,  envoking the  Decode Function  again will 
  190.  allow PGP access to the Public Key...
  191.  
  192.       Note that when decoding a signed  message, PGP  will alert  you if  it 
  193.  fails  the  verification  process...  other-wise the  message will  just be 
  194.  stripped of the signature.
  195.  
  196.      Encrypt Function:
  197.       PGP provides  for the  ability to  encrypt for  multiple recipients... 
  198.  GenMsg uses  this ability  to allow  you the  ability to  Decode a  message 
  199.  you've  encrypted  to someone  else, by  encrypting it  for the  designated 
  200.  person(s) AND yourself.  This feature allows  you to  re-edit a  message if 
  201.  you need to.
  202.       When GenMsg passes the  "encrypt-to" name  to PGP,  it is  enclosed in 
  203.  quotation marks (" ").  If you wish to encrypt for multiple recipients, you 
  204.  MUST enter their names (when GenMsg asks for this info) in this manner:
  205.  
  206.  first name" "second name" "third name","etc...
  207.  
  208.      NOTE that the begining and ending quotation marks are NOT  added!  Each 
  209.  name is separated by quotation  marks separated  by a  space.  This  string 
  210.  cannot exceed 256 charaters in length.
  211.  
  212.      Signing Messages:
  213.       GenMsg can call PGP to sign a message in one of two  modes: Clear-Text 
  214.  Mode, and Ascii-Armor Mode.
  215.  
  216.       Clear-Text mode is the most used, as the  text of  the message  can be 
  217.  read without the use of PGP.  Calling PGP to Decode a Clear-Text message is 
  218.  done to VERIFY that the message-text has not been altered,  and was  signed 
  219.  by the person who owns the Public Key used for verification.
  220.  
  221.       Ascii-Armor  signatures  appear to  be encrypted,  and cannot  be read 
  222.  without proccessing them with PGP.  Altho they appear to be encrypted, they 
  223.  are not... anyone using PGP can process it for viewing, the Decode function 
  224.  verifies that the text has not been altered, and that it was signed by  the 
  225.  person owning the Public Key used for verification.
  226.  
  227.  
  228.  
  229.      PLEASE NOTICE THIS!
  230.  
  231.       GenMsg would not be what it is, were it not for the input received  by 
  232.  those  who   are  thoughtful   enough  to   provide  suggestions   for  its 
  233.  improvement...  I appreciate ALL who have assisted in this manner.
  234.  
  235.       Special thanks are due to those who not only provided suggestions, but 
  236.  incentive, encouragement, and other  types of  assistance... without  which 
  237.  GenMsg would have stopped progressing long  ago. (I  personally don't  mind 
  238.  programs without  "glit 'an  glitter" features...  ) Those  who have  had a 
  239.  significant impact upon GenMsg include:
  240.  
  241.      - Christopher Baker at 1:374/14
  242.      - Barry Kapke at 1:125/33
  243.  
  244.       And last  but not  least, Tom  Jennings... without  whom none  of this 
  245.  would have ever been necessary...
  246.  
  247.                                      -gk
  248.  
  249. For additional information contact:
  250.      GK Pace
  251.      4590 Dixie Way
  252.      Mims, Florida USA 32754
  253.      (407)269-3088
  254.      1:374/26 @ FidoNet
  255.      gkp@f26.n374.z1.fidonet.org
  256.